home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
8bitfiles.net/archives
/
archives.tar
/
archives
/
compuserve-file-archive
/
15 Orphan Computers
/
DDTED.DOC
< prev
next >
Wrap
Text File
|
2019-04-13
|
20KB
|
793 lines
Disk Doctor C16 & Plus/4
Commodore Business Machines Limited
CANADA
October 1984
Disk Doctor Documentation
Disk Doctor Instruction Manual
Table of Contents
Contents Page
1.0 Introduction ................... 3
2.0 Loading and Running Instructions 4
3.0 Commands ....................... 5
3.A Change byte under cursor .. 5
3.B Text mode ................. 5
3.C Drive to access ........... 6
3.D Unit to access ............ 6
3.E Block ..................... 7
3.F Increment sector............ 7
3.G Decrement sector............ 7
3.H Quit ...................... 8
3.I Stop ...................... 8
3.J Jump ...................... 8
3.K Next ...................... 8
3.L Rewrite sector ............ 9
3.M Print the sector .......... 9
3.N Help ...................... 10
3.O F1 ........................ 10
3.P F4 ........................ 10
3.Q F2 ........................ 11
3.R F5 ........................ 11
3.S F7 ........................ 11
4.0 Examples ....................... 12
page 2
Disk Doctor Documentation
1.0 Introduction
The objective of the program 'Disk Doctor' is to allow easy
manipulation of data and correction of errors on floppy
diskettes. The operation of the program has intentionally
been kept simple to allow more users the ability to make use
of it's capabilities. Although the use of the program has
been kept simple the data that can be altered on the floppy
is in a specific order. One of the best sources of
information about how data is written and stored on a floppy
diskette is the manual which came with your disk drive.
This program has the power to ruin diskettes as well as
reclaim information from them. It is for this reason that
we strongly suggest you become familiar with the directory
structure and file chaining format covered in your disk drive
manual.
Throughout this manual you will see '[return]' this indicates
that the return key should be depressed.
page 3
Disk Doctor Documentation
2.0 Loading and Running Instructions
'DISK DOCTOR.TED' will work on the Commodore 16 and Commodore
Plus/4 computers and is written in machine language with a
one line basic driver. In this way loading is very simple as
follows :
DLOAD "DISK DOCTOR.TED" [return]
This statement will load the program into the memory space
normally occupied by basic programs. If you were to ask for
a 'LIST [return]' you would see :
16 sys (4128)
To start 'Disk Doctor' type in 'RUN [return].' At this point
you will see a screen with the title of the program, a few
instructons and you are ready to go.
There are several commands and functions that Disk Doctor can
perform. If you are just getting started and wish to
experiment, use a diskette which does not contain any
valuable information. Altering information on the diskette
can corrupt the entire diskette.
The commands in section 3.0 of this manual will detail what
each of the commands are capable of doing. In every command
as a precaution the STOP key will exit the command without
the function of the command taking place.
NOTE : Disk Doctor can irreparably modify a diskette's data.
page 4
Disk Doctor Documentation
3.0 Commands
3.A '@' Change byte under cursor
The change byte under cursor is envoked by depressing the
'@' key.
When the change byte command is called a prompt is printed in
the message buffer under the data box as follows :
CHANGE BYTE NEW VALUE [D/$H]=
The program now wants you to input either a decimal value
between 0-255 [return] or a hexidecimal value between 00-ff
preceeded by a '$' followed by [return]. After inputting the
value the program will change that byte under the cursor on
the screen, change this character's color to red and change
the byte in the disk drive buffer. This change will not be
written to the floppy diskette until the execution of the 'R
rewrite' command discussed later in section 3.L. The Change
byte command can be exited with the use of the STOP key.
3.B 'T' Text mode
The text mode is envoked by depressing the 't' key.
When the text mode command is called the screen border color
becomes orange and a prompt is printed in the message buffer
under the data box as follows :
TEXT MODE : Press Return to Exit
The program now allows you to alter the data by simply typing
on the keyboard. Data may be typed in upper case or lower
case with reverse on or off. You may use the cursor keys to
position the cursor anywhere in the data box. As each byte
is typed the byte is changed under the cursor on the screen,
that character's color is changed to red and the byte in the
disk drive buffer is changed. As in the Change byte command
this change will not be written to the floppy diskette until
the execution of the 'R rewrite' command discussed later in
section 3.L. After striking the [return] key to exit the
Text mode the message is removed from the screen and the
border color returned to purple. The Text mode can also be
exited by using the STOP key.
page 5
Disk Doctor Documentation
3.0 Commands
3.C 'D' Drive to access
The Drive command is envoked by depressing the 'd' key.
When the drive command is called the cursor will be flashing
on the number to the right of Drive in the upper information
box. At this point you have several options. One option is
to enter a '0' or a '1' to specify the drive to access.
Another option is to enter 'u' to change the unit that the
program will access. The 'u' command is detailed in the next
section 3.D. Help can also be obtained from the drive option
by depressing the 'HELP' key. If the number already contains
the value you require then simply strike the [return] key and
the program will go to the disk drive, get the data from this
block and display it on the screen. The program can also be
exited by using the STOP key from the drive command.
3.D 'U' Unit to access
The Unit command is envoked by depressing the 'u' key.
When the unit command is called the cursor will be flashing
on the number to the right of 'Unit' near the bottom of the
screen. The unit can be any number from 8 to 15 inclusive.
If you have a second drive connected as unit 9 then this
command will instruct 'Disk Doctor' to access that disk
drive. If the number already contains the value you require
then simply strike the [return] key.
page 6
Disk Doctor Documentation
3.0 Commands
3.E 'B' Block
The Block command is envoked by depressing the 'b' key.
When the block command is called the cursor will be flashing
on the first character of the two digit number to the right
of 'Track' in the upper information box. The program is now
waiting for you to input a track number. After the track has
been input the cursor immediately moves to the two digit
number to the right of 'Sector' in the upper information box.
The program is now waiting for you to input a sector number.
When the block has been input (ie. Track and Sector) the
program will go to the disk drive , get the data from the new
block and display it on the screen. The program can also be
exited by using the STOP key while inputting the track or
sector.
3.F '+' Increment sector
The Increment sector command is envoked by depressing the '+'
key.
When the increment sector command is called the you will see
the two digit number to the right of 'Sector' in the upper
information box become incremented by one. After this
increment the program will go to the disk drive , get the
data from the new block and display it on the screen. This
command is useful if you want to look through all of the
sectors in a particular track.
3.G '-' Decrement sector
The Decrement sector command is envoked by depressing the '-'
key.
When the decrement sector command is called the you will see
the two digit number to the right of 'Sector' in the upper
information box become decremented by one. After this
decrement the program will go to the disk drive , get the
data from the new block and display it on the screen. The
decrement command will only decrement the sector to a value
of 00. This command is useful if you want to look through
all of the sectors in a particular track.
page 7
Disk Doctor Documentation
3.0 Commands
3.H 'Q' Quit
The Quit command is envoked by depressing the 'q' key.
When the quit function is called all of the disk files are
closed and control is returned to direct basic mode.
3.I 'STOP'
The Stop command is envoked by depressing the 'STOP' key.
This command is identical to the Quit command. When the stop
function is called all of the disk files are closed and
control is returned to the direct basic mode.
3.J 'J' Jump
The Jump command is envoked by depressing the 'j' key.
When the Jump command is called the track and sector for the
block are read from the byte under the cursor and the next
byte respectively. The program will go to the disk drive ,
get the data from the new block and display it on the screen.
This command is useful when following the forward links of a
file starting from a directory entry.
3.K 'N' Next
The Next command is envoked by depressing the 'n' key.
When the Next command is called the track and sector for the
block are read from byte 0 and byte 1 respectively. The
program will go to the disk drive , get the data from the new
block and display it on the screen. This command is very
useful when following the forward links of a file.
page 8
Disk Doctor Documentation
3.0 Commands
3.K 'R' Rewrite Block to Floppy
The Rewrite command is envoked by depressing the 'r' key.
When the change byte command is called a prompt is printed in
the message buffer under the data box as follows :
REWRITE BLOCK ARE YOU SURE [y/n]
The program is now waiting for you to answer 'y' to continue.
If you answer yes to this prompt the data from the data box
will be written to the floppy diskette in it's present form
whether it was altered or not. Of course if the
write-protect notch is covered the attempt to write to the
disk will fail. Depressing any key (including the 'STOP'
key) but the 'y' key will abort the Rewrite function.
3.M 'P' Print the sector
The Print command is envoked by depressing the 'p' key.
When the print command is called a prompt is printed in the
message buffer under the data box as follows :
HEX DUMP TO PRINTER ? [y/n]
The program is now waiting for you to answer 'y' to continue.
If you answer yes to this prompt the printer will print the
hexidecimal values and of the data box as well as an ASCII
representation of the data. Pressing any key other than the
'y' key will abort the print function.
If there is a problem with the printer (ie. not connected or
turned off) a prompt will be printed in the message buffer
under the data box as follows :
NO PRINTER CONNECTED
In this case depressing any key will return you to the
command mode.
page 9
Disk Doctor Documentation
3.0 Commands
3.N 'HELP' Help
The Help function is envoked by depressing the 'HELP' key.
When the Help function is called a screen full of information
containing a quick summary will appear. Depressing any key
at this point will return you to where you left.
3.O 'F1' Function Key
The F1 function is envoked by depressing the 'F1' key.
When the F1 function is called, this will cause the program
to read and display Track 18 Sector 00. This is a quick way
to display the first block of the directory file chain.
3.P 'F4' Function Key
The F4 function is envoked by depressing the 'F4' key.
When the F1 function is called, this will cause the program
to read and display Track 18 Sector 01. This is a quick way
to display the second block of the directory file chain.
page 10
Disk Doctor Documentation
3.0 Commands
3.Q 'F2' Function Key
The F2 function is envoked by depressing the 'F2' key.
When the F2 function is called, this will cause the program
to read and display Track 01 Sector 00. This is a quick way
to display the inner most track on a 1541 disk drive.
3.R 'F5' Function Key
The F5 function is envoked by depressing the 'F5' key.
When the F5 function is called, this will cause the program
to read and display Track 35 Sector 00. This is a quick way
to display the outer most track on a 1541 disk drive.
3.S 'F7' Function Key
The F7 function is envoked by depressing the 'F7' key.
When the F7 function is called, this will put three carriage
returns in the keyboard buffer. This is useful to accept the
defaults from the screen when inputting the block information
(ie. track and sector).
page 11
Disk Doctor Documentation
4.0 Examples
The following are examples of how the 'DISK DOCTOR.TED' could
aid in manipulating and reclaiming data on a diskette.
Unscratch a scratched file
The first example is how to unscratch an inadvertantly
scratched file. Refer to the disk drive manual for details
on the file type byte in the directory entry.
After a file is scratched the file type byte in the directory
entry is changed to a value of zero (0). All of the data in
that file remains on the disk untouched until another file i
written on the disk. So if you have just scratched a file
and have not written another to the disk the following will
reclaim the file as good as new.
The file type byte need only be changed back to the number
which represents it's file type (ie. $81 seq, $82 prg, $83
usr, $84 rel) and then VALIDATE the disk to allocate the
blocks in the bit avalability map (BAM) and the file has been
recovered.
Change Diskette Name
The name of the diskette is stored in the directory track 18
sector 00 of a 1541 disk drive. Using 'DISK DOCTOR.TED' you
can modify the title that the disk was given when it was
formatted.
Use the program to display track 18 sector 00 and position
the cursor to byte 144 which is the beginning of the 16
character diskette name. Enter the TEXT mode and type in the
new diskette name. When you have finished altering the name
depress [return] to exit the TEXT mode. To make this change
permanent use the REWRITE function descirbed in section 3.L.
page 12